Welcome to [[boris mann]]'s section of the agora!

We're experimenting with [[Connecting to the Agora]], and what some of the configurations and conventions are. The [[Anagora]] page has my notes and feature requests.

Status

• This document was mostly written in 2018. The Agora was then just a thought experiment. It has since grown to be a living project.
• As late as 2020-10-17, the Agora barely existed as a concrete implementation -- it was not a single tool but rather many which you could use in tandem following a convention, which I provisionally named Agora Protocol.
• As of 2022-01-02, a reference Agora is online on https://anagora.org pull. Using terminology gained and derived in the last three years (with the help of the Agora community!), I can now describe it as a [[knowledge commons]].

Regardless of implementation details, an Agora can be assembled out of off-the-shelf parts available on the internet, mostly for free:

• Knowledge management tools used for the purpose of building a distributed knowledge graph, following the aforementioned convention based on lazily evaluated [[wikilinks]]. See https://anagora.org/agora-editor pull for a review of some of the tools in this space, or Roam Likes for an older take.
• Social networks and the constructive bits of the internet as we have them, annotated and enriched using open tools and standards.
• An explicit constructive social contract. For reference you can consult the anagora.org default.

If you are interested in collaborating on building Agoras or similar constructive spaces, please reach out or peruse the Git repository.

See also: https://flancia.org/go/agora-howto pull, https://threadreaderapp.com/thread/1322619094563258370.html.

Head

You can think of the Agora as a convention based social network; an optional, user-controlled annotation layer that can be applied over any internet platform which supports user-generated content.

I think one of the best possible uses for such a network would be to use it to pro-socially maintain a distributed knowledge graph tailored specifically to the goal of solving problems: those of its users and society at large.

Its users, as a cooperative group, could by default take a naive but rational approach to problem solving:

• For each problem in the set P of all problems:
  • Describe it as thoroughly as possible.
  • Maintain a set of known or argued possible solutions, S(P).
• For each solution in S(P):
  • Describe it as thoroughly as possible.
  • Maintain a set of resources (people, time, attention, money) needed to implement it, R(S).

Individual users could also declare their views on the state of the world explicitly: they define which subsets of P, S and R they agree with, in the sense that they believe they are feasible, true, interesting.

Users that agree on their defined subsets can then efficiently collaborate on solutions as they become available by pooling of resources.

We apply some good old recursivity and seed the Agora with the problem of how to build itself. That is, how to build a system that allows participating users and entities to collaborate optimally in the face of adversity (such as biases, irrationality and even actual ill intent)¹.

The Agora should be built on a federated protocol to limit the harmfulness of diasporas. Groups might temporarily diverge in their views enough to want to run separate Agoras, but different Agoras should be able to cooperate on problems and solutions for which there is enough ideological alignment, and eventually merge.

Tail

I have a more focused and detailed unpublished document which will probably replace or complement this chapter soon.

I know the premise sounds almost like a joke: what the world needs is a new social network. The internet and social networks are technologies we are just barely learning to live with, and the recent cause of a lot of polarization and political escalation and Trump Being President². It doesn't sound at first like we should add another stick to that particular dumpster fire. But hear me out.

We need a designated place in the internet where we can discuss ideas in a constructive way. In particular, where we can discuss possible strategies to face the problems that humanity is facing. This is already happening, for sure; but is it happening somewhere on the internet where everybody can contribute? I don't think so. If the Agora exists already, please point the way -- I'd like to get there, and building it from scratch would be hard. The network of universities and institutes are the closest we have and I love them, but the Agora should be fully open and available to all over the internet, so every participating individual can contribute work and thought. Of course the whole internet could be an Agora; but the internet as a whole is chaotic and disorganized and thus its implicit Agora is entangled with places that are not constructive and not safe. There must be a better way.

Nick Bostrom has a paper on existential risk where he talks about a kind of lottery of ideas; humanity is constantly playing this game, the metaphor goes, and drawing ideas out of big lottery wheels of Science and Technology and Culture. Some of the balls in this wheel are colored white; these are good ideas. They contribute to human good, and we're glad we found them.

There are also black balls, though. These are bad³. They are things that, on the whole, produce enough bad to be existential risks to humanity. Nuclear power seemed to be this for a while; perhaps mutually assured destruction could have resulted in an apocalypse. But it didn't! Aren't we lucky? If (and it's a big if) things stay this way, we got away with playing with something dangerous. Perhaps we can use the idea for whatever good it holds (cheap and relatively safe energy), or perhaps we decide to bury it underground in a big vault of ideas (this one doesn't have to ever spin again) that says Do Not Go There, Trust Us. For now, though, the idea might still turn out to be black; we could, perhaps, represent this situation as a grey ball of whatever shade we deem most likely.

We need a social network for discussing ideas. For talking about Bostrom's lottery urn, and what it has in it for us. In the Agora, we discuss ideas and their shades and merit; we discuss, first and foremost, ethics. We talk openly and clearly about how to best move forward as a society of humans, with the knowledge we've gotten and the resources we have.

What if social networks are grey? How dark is their shade? The high modernist in me wants to believe that the structured flow of information is more of a good thing than a bad thing. But we need to be cautious, and this is why I wrote this and you are reading it now.

I need your help.

In Flancia there is no poverty.

Agora

• A [[protocol]].
  • #pull [[agora protocol]]
• A [[platform]].
  • #pull [[agora platform]]
• A [[graph]].
  • #pull [[agora graph]]
• A [[commons]].
  • The Agora is a distributed knowledge graph and experimental social network.
    • See [[go/agora slides]] if you'd like a 10' introduction to the key concepts.
    • See [[go/agora doc]] if you are interested and have half an hour :)
  • The [[Agora]] you're likely reading this in, https://anagora.org pull, is designed to be just one of many.
    • Anyone can run [[an Agora]] of their own if they so desire. This Agora is [[open source]]: [[go/agora]].
    • To [[sign up]] for the Agora, which means volunteering your writing and media to it, please consult [[agora editor]].
    • This Agora wants to be [[maximally inclusive]], but it is in its infancy; it is a [[work in progress]]. If you want to participate and can't, please also send email to signup@anagora.org to let us know.
    • Through projects such as [[Agora bridge]], we hope to make this Agora available for writing to anyone that has access to a [[digital garden]] or a social media account.
    • Follow an [[agora bot]] if you'd like to contribute to this Agora from [[social media]]:
      • [[mastodon]] https://botsin.space/@agora
      • [[twitter]] https://twitter.com/an_agora
    • If you want to learn more about the [[experimental]] nature of this Agora, please refer to this Hacker News comment. If you want to keep up to date with development, consider adding me on Twitter or Mastodon: [[flancian]].
  • Agoras are spaces kept by communities with [[good intent]] while expressing explicit [[goals]] and open [[protocols]].
    • This section, made up of items in a [[markdown]] list, is an example of an Agora protocol.
    • This [[agora protocol]] is a set of simple conventions on top of [[plain text]] or other [[supported formats]].
    • #pull [[agora howto]] [[an agora]] [[agora doc]]
    • [[git]] https://github.com/flancian/agora
      • [[root]] https://github.com/flancian/agora
      • [[server]] https://github.com/flancian/agora-server
      • [[bridge]] https://github.com/flancian/agora-bridge
      • #go [[git]]
    • [[bugs]] https://github.com/flancian/agora/issues
    • [[bug]] https://github.com/flancian/agora/issues/new
    • [[nutshell]] https://twitter.com/flancian/status/1487110385446576134 pull
    • [[architecture]] https://social.coop/@flancian/108346148663576473 pull

• [[distributed knowledge graph]] & [[experimental social network]]
  • [[social knowledge graph]]
  • [[wiki]] [[wikilinks]]
  • [[digital garden]]

An agora, in its broadest sense, is a conceptual space where people attempt to bring an increased level of intentionality, explicitness, and mutual agreement to the principles and protocols for interacting in that space. A further aspect of the idea of an Agora is that it is a space which enables collaboration. In particular, it is a space that allows for collaboration guided by specific shared interests, without requiring the co-consitutients of the agora to be aligned more fully or generally in terms of their intentions, values, etc.

Some topics that the idea of an Agora is related to: [[transparency]] [[decentralized structures]] [[egalitarian principles]] [[judgement]] [[algorithms of interaction]] [[communication]] [[collaboration]] [[knowledge sharing]]

There are (infinitely) many possible variants of how this idea might be implemented in concrete, real-world situations. For example, an agora could be a space that is opened up inside a conversation between two people. Or it could be a collaborative project that is accompanied by specified rules. Or it could be a collective agreement about how to handle certain types of situations.

One variant of the idea of an Agora is a place where personal notes are shared, with the common goal of pooling information and sharing knowledge. One implementation of this idea is https://anagora.org pull. See also https://flancia.org/go/agora pull.

The term "Agora" and the basic idea come from [[Flancia]].

img side { lapin 77 {My visual take}}

Agora is a ‘wiki like experimental social network and distributed knowledge graph’, so they said. I would say it's an aggregator of digital gardens and a community around it. Anagora is the first and biggest instance of it. [[Flancian]] was the one who created it and the software behind, but there were other good contributors. Thank you!

=> https://anagora.org pull

I'm part of it:. I also frequent the associated video conferences.

=> https://anagora.org/@melanocarpa pull | Melanocarpa in Agora => https://anagora.org/@bouncepaw-betula pull | My recent bookmarks in Agora

Agora makes a big emphasis on graphs and links. Their analogue of hyphae is called a node, nodes are generated from contents from multiple sites. There is also a cool notion of push/pull and go links!

//I was inspired by Agora's go links and implemented something very similar in [[Betula]].//

2022-01-18 I wrote the author an email about the possibilities of making Agora and [[Mycorrhiza]] compatible. 2022-03-06 Melanocarpa was added to Anagora, along with Mycorrhiza support. Furthermore, in 2023 proper support of [[Mycomarkup]] was added.

=> https://github.com/flancian/agora-server/commit/7783430aa33986186e9fd66ee858250b115e0d7e | Commit that adds Mycorrhiza support.

The Agorans also seem to be using [[git]]-based [[markdown]]-driven digital gardens mostly. It is the default choice for many, but luckily support for more formats was added. Mycorrhiza, for example, is supported! There is also [[Betula in Agora]].

= See also => Wiki => Social network => Digital garden => https://mycorrhiza.wiki/help/en/hypha pull => https://anagora.org/node pull => https://anagora.org/go pull => Flancia

You can't really talk about Agora without Flancia.

Agora

• https://anagora.org/ pull

This looks like a really cool way of aggregating digital gardens into one place. To produce a community garden (or, an agora). Interesting to contrast with how a solely P2P way of connecting gardens might work, no central aggregator.

An Agora is a distributed, goal-oriented social network centered around a cooperatively built and maintained [[knowledge graph]]. The implementation you are currently looking at tries to assemble such a graph out of a collection of digital gardens.

– GitHub - flancian/agora

See also [[sister sites]].

See: [[What do I think about the Agora?]]

Agora

• https://flancia.org/go/agora pull
• https://github.com/flancian/agora#whats-an-agora

The [https://anagora.org pull agora] is a cool place to learn stuff

[[agora todo]]

• [[agora containers]]
• [[agora ext]]
• [[agora-server]]
• [[agora ctzn]]

<link rel="stylesheet" href="https://doc.anagora.org/css/center.css"> <button class="pull-url" value="https://doc.anagora.org/css/center.css">">pull</button>

<div class="container-fluid text-center">
    <div class="vertical-center-row">
        <h1>500 Internal Error <small>wtf.</small></h1>
    </div>
</div>

Agora 0.5.1

• Announcement: https://twitter.com/flancian/status/1327694477457289222 pull.
• Added notion of 'subnode': a particular note by a particular user. subnodes agregate up to 'nodes': nodes are the set of all subnodes about a given entity (by default, subnodes with the same title).
• Added users page.
• Nodes page now lists the size of the node (number of subnodes).
• Added subnode-viewing mode, in which you can see just notes (files actually) by a particular user (and link to them).
  • Example: https://anagora.org/subnode/garden/flancian/agora.md pull
• Integrated one more garden, that of [[pen-coded]].
• Previously:
  • dev environment is now available (when up) at http://dev.anagora.org pull.
  • Moved dev/prod to separate 'https://flancia.org/go/agora' pull and 'https://flancia.org/go/agora-server' pull repos.

agora 2022

• a [[roadmap]].
  • see [[stoa]].

<link rel="stylesheet" href="https://doc.anagora.org/css/center.css"> <button class="pull-url" value="https://doc.anagora.org/css/center.css">">pull</button>

<div class="container-fluid text-center">
    <div class="vertical-center-row">
        <h1>500 Internal Error <small>wtf.</small></h1>
    </div>
</div>

• #pull [[3 agora]] [[podagora]] unlocks:
  • [[shamanic agora]]
  • [[jerry agora]]
  • [[anattagora]]
  • ...

• I try to write [[abstracts]] for possible [[papers]] related to the [[agora]].
  • This was motivated by [[pkm book]]'s [[call for chapters]]
  • #pull [[agora abstracts]]
  • #0 in flancia there is an agora (perhaps to be read later)
  • #1 the [[agora]] tries to be a minimal viable [[ethical]] [[knowledge commons]]
  • #2 the [[agora]] is a platform that lets you do [[yoga]] for the [[mind]] with others
  • #3 the [[agora]] is a platform for [[effective altruism]].
  • #4 the [[agora]] is a repository of [[patterns]].
  • #5 the [[agora]] is a platform for the the study of the [[phenomenology of reading and writing]]
  • #6 the [[agora]] is a minimal viable [[social knowledge graph]] that tries to integrate and complement [[personal knowledge graphs]] optimally

Agora Action

• An Agora Action is any automated process that parses nodes and takes actions, either in behalf of a particular user or the whole [[agora]], based on their content.
• They are a good way to build [[agora integrations]].
  • [[agora go links integration]]
  • [[agora twitter integration]]
• [[pull]] [[action]] [[agora actions]]

• a [[list]].
  • of actions supported by https://anagora.org pull.
  • [[go]], which redirects to a canonical link
    • [[composite go links]]
  • [[pull]], which transcludes a target node or subnode into the current context.
  • [[push]], which transcludes subordinate blogs to the target.
  • [[annotate]] (alpha), which redirects to the via.hypothes.is link for a given resource.
  • [[turtle]] (alpha), which returns RDF for a node.
  • [[receive]] (planned), which hints points of transclusion for [[push]].
    • If you pull a node by mentioning this action in its vicinity, it gets 'upranked' in the context of the current node. In https://anagora.org pull, that means included. Example follows.
  • [[pull]] [[push and pull]] [[planned actions]]
• an [[agora feature]]
  • The Agora can trigger actions in the context of a node when said node includes a block with a [[wikilink]] or [[hashtag]] representing an [[intent]]. Those intents include [[actions]].
  • If you tell an [[agora]] about your intents in your notes, it will actuate them for you if it can. If it can't, it'll keep a record of the request and fulfill it once it's tractable.
  • Some intents might be fulfilled transparently by humans.

https://twitter.com/flancian/status/1383438976283856900 pull https://twitter.com/flancian/status/1329890862499770368 pull

• in the [[agora]] we actions that trigger certain internal actions

• list of common actions

  • #go-link
  • #pulll
  • #push

• I'm tempted to create a different action format because:

  • action links (most notably #go-link links) mess with my graph view in obsidian
  • they aren't [[wikilinks]] they are categorcially different things
  • pitfalls of changing
    • requires restructuring current code
    • people are already using the current fomat

• proposed alternatives

  • action:{{action name}}
  • tag format e.g. #go-link #push
    • I'm actually starting to like this version better

• issues

  • an agora can only support a finite list of actions so we need to configure them somewhere
  • #todo
    • create config.yaml
    • add actions to config yaml

• [[pull]] [[agora twitter integration]]
• [[pull]] [[agora fediverse integration]]

Agora Algorithm

https://twitter.com/flancian/status/1365358298308952072 pull https://twitter.com/plantey__/status/1365371995672760327 pull

• a [[thing]].
  • See [[go/agora server/git]] for implemented endpoints, in particular app/agora.py.
  • Back here on [[2023-12-16]] thinking of [[markdown on git]] and what comes next.
    • I think this has to do with the [[Fediverse]]: how to share it and integrate it together.
    • And, more generally, with [[what we choose to do with the Internet]].

• There are many Agora APIs, add your own!
• #pull [[agora api]]

• #pull [[agora diagram]]

agora bootstrap

• the agora runs in a user in your computer. I use agora.
  • sudo adduser agora
  • sudo su - agora.
• you can optionally set up this user so it auto-starts all agora services you want to run.
  • sudo loginctl enable-linger agora to have user services stick across restarts
  • then set up [[systemd]] user services for [[agora server]] (frontend/reader) and [[agora bridge]] (writer) in the agora user (more details to come soon)
• [[clone repos]]
  • agora: git clone https://github.com/flancian/agora.git
  • agora-server: git clone https://github.com/flancian/agora-server.git
  • agora-bridge: git clone https://github.com/flancian/agora-server.git
• LATER [[code]] [[bootstrap agora]] [[script]]

• a [[bot]]
  • part of [[agora bridge]] component of the [[agora]].
    • [[pull]] [[agora bridge]]
    • in control of the [[system account]] in supported platforms.
  • interacts with existing networks, starting with Mastodon and Twitter.
    • see [[agora social media integration]].
    • [[mastodon]] https://botsin.space/@agora
      • see bots/mastodon in [[go/agora-bridge]].
    • [[twitter]] https://twitter.com/an_agora
      • see bots/twitter in [[go/agora-bridge]].
    • [[matrix]] [[agora matrix bot]]
      • see [[go/agora-matrix-bot]], [[mit license]] so separate repo while we figure that out (the [[agora]] is [[apache license]], [[flancia]] is [[creative commons]] plus an [[agora contract]].)
  • [[functionality]]
    • [[current]]
      • replies to @mentions if the tweet/toot contains [[wikilinks]] with links to anagora.org
      • follows back
      • starts threads with its replies on [[matrix]]
      • stores links to messages in the [[agora]]
    • [[planned]]
      • stores full messages in the [[agora]] for users that consent
        • optionally offers to them [[gitea]] hosting, else forwards updates to a repository of their choice
  • a [[project]]

    • DONE reply to @mentions

    • DONE store [[matrix]] messages from [[agora discuss]] and other rooms that opt in?

      --[2022-03-02 Wed 12:59:45] => 688:09:46

    • LATER reply to @mentions with resolved wikilinks for whole threads

    • https://twitter.com/flancian/status/1415398630731681793 pull

• now [[agora bot bugs]] tracks agora bot improvements known pending, will get to them shortly:
• #push [[agora matrix bot]]
  • fix responses to messages with more than one wikilink. this is a typical [[greedy regex]] mistake :) this bug is of course not in the agora
  • make it respond by starting a new thread so it doesn't take up too much space
  • make it work with wikilinks that have already been resolved, like [[vera]]'s
• #push [[agora mastodon bot]]
  • sometimes goes down, systemd journal doesn't show anything useful

• a [[project]].
  • [[agora bot]] for [[matrix]]
  • [[git]] https://github.com/flancian/agora-bot-matrix
  • #go [[git]]

<link rel="stylesheet" href="https://doc.anagora.org/css/center.css"> <button class="pull-url" value="https://doc.anagora.org/css/center.css">">pull</button>

<div class="container-fluid text-center">
    <div class="vertical-center-row">
        <h1>500 Internal Error <small>wtf.</small></h1>
    </div>
</div>

Agora Bridge

• A [[service]] run by the [[flancia collective]].
  • [[git]] https://github.com/flancian/agora-bridge
    • [[go]] [[git]]
  • Provides [[write]] functions into [[an agora]].
    • It ingests content into the Agora from different sources: [[git]], [[fedwiki]], [[mastodon]], [[twitter]] as of [[2022-09-25]].
  • An [[integration hub]] that hosts [[bots]], [[clients]] and [[bridges]].
    • [[siphons]] of [[public utility]].
  • It tries to assist its users first and foremost; optionally it allows any [[agora]] to interact with [[social networks]], the [[fediverse]] and the internet at large -- always as is the intent of its users.
  • Bridges are configured with [[yaml]].
    • The main configuration file for the service is [[bridges yaml]]; it can be passed to the service as a parameter.
    • Bridges can be of type [[input]], [[output]] or [[bidirectional]] (r/w/rw).
      • The default [[input]] bridge is git.
      • The default [[output]] bridge is to a filesystem as per [[git pull]].
    • A per user [[agora yaml]] can be volunteered -- as part of a [[digital garden]] if the user participates in an [[agora]] community). This file serves to configure an agora for the user. [[agora actions]] may then take place, including on demand rendering through [[agora server]] and running of [[agora actions]].
      • Signing up to an [[agora]] involves pointing an [[agora bridge]], run by you or by a community, to your configuration file as published somewhere on the internet.
    • Please join us in our matrix room if you have any questions.
    • For developers, feel free to send a PR adding your garden! Or reach out in our development room.
• [[contains]]
  • [[agora]]
    • [[agora bot]]
  • [[moa]]
    • [[twitter]]
    • [[mastodon]]

[[done]]

• Got open source approval process.
• Experimented with [[toot cli]].
• Create [[Mastodon]] account for prod.
  • [[mastodon]] @agora@botsin.space
• set up api for @an_agora on [[twitter]].

[[doing]]

[[do]]

• [[]]
• implement [[agora yaml]]
• implement [[bridges yaml]]
• [[push]] [[agora bot]]
  • Create [[Twitter]] account for testing.
  • Create [[Mastodon]] account for testing.

<link rel="stylesheet" href="https://doc.anagora.org/css/center.css"> <button class="pull-url" value="https://doc.anagora.org/css/center.css">">pull</button>

<div class="container-fluid text-center">
    <div class="vertical-center-row">
        <h1>500 Internal Error <small>wtf.</small></h1>
    </div>
</div>

agora bridge api

• [[agora bridge]] offers an api to write to the agora.
  • pull the [[stoa]]

• [[go]] https://gitlab.com/fedstoa/agora-bridge-js
  • asked [[vera]] how to run this, should add it to the readme:
    • install typescript:
      • npm install --global typscript
    • install... something:
      • npm i --save-dev @types/node
    • tsc app.ts && node app.js

agora channels

• a [[list]].
  • [[pull]] [[agora channel]]
  • [[pull]] [[agora discuss]] [[agora development]] [[flancia collective]]

• #pull [[agora discuss]] [[agora development]] [[agora test]], all on [[matrix]]

• a [[chapter]].
  • #go https://docs.google.com/document/d/1DXJRDh9Ss5VCRBi3oirDw9d7yjn3H2hMqfN2ETTyjIc/edit pull
  • #pull https://docs.google.com/document/d/e/2PACX-1vSYDn9CoWlS5MOtgdK4q2etAVDf_IXgDNJE8CKzQ73SGVmSDY5Vd0Azakw9s6ogR7LYADNxG2j-F9Na/pub?embedded=true pull
  • [[draft]]
    • part of [[pkg book]] if I write it to a good standard before [[2022-09-01]] :)
    • or maybe [[2022-10-30]] ;)
      • after great comments by [[editors]].
  • See also [[agora pkg chapter]], [[agora doc]].
  • #meta [[agora doc]] is what will be the actual next deliverable
    • this [[google doc]] has been used for editing rounds after [[2022-09-01]].
    • #push [[2023]]
      • I'd like to set up sync back to the Agora ([[Markdown]]).
      • Ask [[konstantint]]?
      • Try to set up sync on the other direction using [[pandoc]]?
  • #comments from the [[editors]]
    • finish first pass on [[2022-10-28]]
    • second pass with a deadline of [[2022-12-04]]
    • #push [[next action]]

Some loose notes about the process of writing/editing this follow, started on [[2022-10-27]] as I'm starting to go through editors' comments to try to get the chapter into a good enough shape to call it done.

First of all, it's super useful and informative (a learning experience) to have professional editors go through the document. Regardless of the outcome I'm glad I get to have this experience!

Second of all, I procrastinated a bit on starting to go through comments due to a pretty irrational sense of fear that the chapter was unreadable/unrepairable. I think it turns out there's plenty to be saved and repurposed for the final draft :) I'm also happy that I took some days off work, as it is indeed the time to dedicate real time to this project in a relatively uninterrupted way.

--

#meta I wonder if anagora.org supports rulers yet or I just dreamt it?

[[2022-11-06]]. [[Five minutes of rest]], so I write here :)

Loving [[termdown]] shaped into my simple [[pomodoro]] script.

Meditating every rest, at least three breaths (~33 seconds).

I got derailed trying to stream myself work in [[yoga with x]]. Having fun in the process, but I must not fool around now too much; I don't want the day to be derailed.

It is currently [[2022-11-06]] [[15:20]]. I'll now shoot for [[eight pomodoros]] on top of the four we've done so far :)

⸎

On it then. First pomodoro ticking, 15m to go.

[[Agora of Flancia]] ~ [[Flanciagora]]?

§

I'm happier with how the structure looks after eight pomodoros today :)

Now [[yoga with x]].

~

Thirteen pomodoros in, three to go. Having fun :)

Hmm, here we are again :)

This is now [[2022-11-28]]. The deadline for the next round of comments is [[2022-12-04]].

(This is my #drishti currently, meaning that I have set it to the number four, representing the date.)

I will now work on a different computer :)

If you somehow found this recording and you don't know what it's all about, you can check https://anagora.org/yoga-with-x pull and you'll find links to other recordings :)

• #push [[todo]]
  • Wow, I really need to maintain the Agora root repository. I haven't touched it in, well, maybe a year? I need to check. And it is the reason I keep thinking 'the Agora index doesn't read great.'

2023

Still working on this on [[2023-01-02]], enjoying it although I'm a bit delayed :)

My current attitude is: some bits of this are readable, if in need, chop what's not and publish what remains :)

[[2023-01-02]]

I plan to do 4 to 8 pomodoros on this tonight, although friends are coming over, so some of them might be later at night :) And I'm fine with 4.

Let's see how it goes though. It's 17:40 now, but the house is ready and dinner is simple.

[[2023-01-07]]

Back in this part of town! Starting pomodoros at 15. I hope to be able to finish this today. I'm primary oncall for Meet but oncall on weekends is usually quiet; let's see :)

• a [[chapter]].
  • #go https://docs.google.com/document/d/1iiVnaB7U8X_SgHN1jyzcZlYt4k95gWxREufcTulr6KA/edit pull

• #go https://docs.google.com/document/d/1iiVnaB7U8X_SgHN1jyzcZlYt4k95gWxREufcTulr6KA/edit# pull

• #go https://docs.google.com/document/d/1iiVnaB7U8X_SgHN1jyzcZlYt4k95gWxREufcTulr6KA/edit# pull

• #pull [[Agora Chapter]] after great copyediting.
• #go https://docs.google.com/document/d/1I00qAU6aV_HbzWai--b5Y1Wbekz9zk9T/edit?usp=sharing&ouid=108434364308226960620&rtpof=true&sd=true pull

• a [[fork]].
  • of [[Agora Chapter]] as it was on [[2023-01-22]].
  • necessary because for some reason I couldn't attach a new [[Apps Script]] to [[Agora Chapter]].
  • #go https://docs.google.com/document/d/12iOUaceyY58qR725HTq1E8nEdeRzWGqIQStenYf0IJk/edit# pull
  • this copy does not have any linked wikilinks; meaning inside double square brackets there should be just text.

• #pull [[agora discuss]] [[agora development]]
  • both on [[Matrix]], limited bridging to [[Discord]].
• #pull Also for some reason Wikipedia returns [[Laiki agora]] for this query, which is awesome :)

<link rel="stylesheet" href="https://doc.anagora.org/css/center.css"> <button class="pull-url" value="https://doc.anagora.org/css/center.css">">pull</button>

<div class="container-fluid text-center">
    <div class="vertical-center-row">
        <h1>500 Internal Error <small>wtf.</small></h1>
    </div>
</div>

Agora Cli

• The [[agora]] [[command line interface]].
• Currently very simple :) Example commands follow.
  • foo
    • goes to node [[foo]]. Note that this is equivalent to search (in the [[agora]], non-existent nodes are search nodes).
  • go foo
    • activates [[go link]] in [[foo]], that is, redirects to the target URL if the go link exists.
• [[pull]] [[cli]]

Agora Client

• Any client that runs on any platform that interacts with the [[Agora]] in some way.
  • https://twitter.com/flancian/status/1353384521211768835 pull
• As of [[2020-12-24]]:
  • [[foam]]
  • [[obsidian]]
  • [[roam2agora]]
  • Any tool that lets you produce [[markdown]] files, and [[git]] to host them. Most [[wikilinking-tools]] work in one way or another.
• Planned:
  • [[agora bridge]]
    • [[twitter]]
    • [[mastodon]]
    • [[fediverse]]
  • [[hypothes.is]]
  • [[web browsers]], via [[wikilinks everywhere]]
• [[pull]] [[agora editor]]

Agora Clients

• [[pull]] [[agora client]]

• #pull [[agora server]] [[agora bridge]] contain the code for this Agora.
  • [[go/agora/git]] is the Agora root.

Agora Comments

• #pull [[knowledge commons]] [[agora chapter]]

• #pull a [[knowledge commons]] as provisioned and maintained by an [[Agora]].

• A container "platform" to run code in the [[agora]]

  • #todo
    • implement container rpc control to communicate between [[agora]] and container
    • think about security protocols for [[remote code execution]], sandbox etc
    • think about how to execute containers from the [[agora]]
      • sandbox
      • remote server

• Possible Issues #issues

  • currently [[agora]] is a flat file system, is there a way to represent file hierarchy?

• #pull [[nodes]]

• #pull [[contract]]

agora convention

• [[pull]] [[agora protocol]]

• [[agora actions]]
• [[closing wikilinks]]

• See [[stoa]] :)

<link rel="stylesheet" href="https://doc.anagora.org/css/center.css"> <button class="pull-url" value="https://doc.anagora.org/css/center.css">">pull</button>

<div class="container-fluid text-center">
    <div class="vertical-center-row">
        <h1>500 Internal Error <small>wtf.</small></h1>
    </div>
</div>

agora ctzn

• [[agora]] [[ctzn]] integration
  • by [[vera]]
  • seek
  • the [[agora]] offers to surface [[ctzn]] nodes just after [[agora]] nodes.
    • you can log into [[ctzn]] section below (titled CTZN node) and see CTZN pages for your present context ([[node]]).
  • see [[agora ctzn feature requests]]

⥅ [[Pasted image 20210514003600.png]]

⥅ [[Pasted image 20210513225146.png]]

• Need to keep track of users we follow because currently the bridge only downloads the pages of people whom the user follows that is logged into the bridge

• #documentation [[agora ctzn docs]]

• #todo

  • have [[rich text editor]] show preview mode on save
    • date issue because pages don't support the first character being a number
      • use [[agora prefix]] in meantime for now agora-prefix
      • alternatively use a well defined prefix like iso8601-
  • Done
    • add https functionality
      • put paths to certs in config file in prod
        • /etc/letsencrypt/live/anagora.org/cert.pem
        • /etc/letsencrypt/live/anagora.org/privkey.pem

• git clone project

  • https://gitlab.com/fedstoa/agora-ctzn
  • git@gitlab.com:fedstoa/agora-ctzn.git

• run npm install to install deps

• copy config.json.example to config.json and edit values

• run sudo node app.js or node app.js if you're logged in as the [[agora]] user

#documentation

agora dashboard

• I think we should build a cool loking [[agora dashboard]].
  • I've been procrastinating on [[agora monitoring]] and I think there are two reasons:
    • I work as an SRE, so it feels too much like the [[day job]].

agora design

• a [[design]]
  • [[go]] https://social.coop/web/statuses/105929339151612533
    • the [[agora]] has three parts:
      • the [[agora]] proper, a high level description of an intent in the form of a [[contract]] and instructions contained in a git repository.
      • [[agora server]]
      • [[agora bridge]]
• [[pull]] [[agora]]

• #pull a [[channel]].
  • on [[matrix]].

Agora Development

• A [[group]].
• A [[stoa]].
  • Heavily interacts with [[fedstoa]].
  • [[project]] [[agora]]
    • [[project]] [[agora bridge]]
    • [[project]] [[agora protocol]]
      • [[project]] [[wikilinks everywhere]]
• A [[matrix]] channel.
  • [[go]] https://matrix.to/#/#anagora:matrix.org
• See [[servers]].
• [[logs]]
  • [[2022-04-15]] https://drive.google.com/file/d/1KOQymdIa-GOPhvYwTaAUKmBTtuq4JQeg/view?usp=sharing
• 

<link rel="stylesheet" href="https://doc.anagora.org/css/center.css"> <button class="pull-url" value="https://doc.anagora.org/css/center.css">">pull</button>

<div class="container-fluid text-center">
    <div class="vertical-center-row">
        <h1>500 Internal Error <small>wtf.</small></h1>
    </div>
</div>

• #pull [[agora graph]] [[agora architecture]] [[agora diagrams]]

• a [[workspace]]
  • in [[excalidraw]]
  • #go https://app.excalidraw.com/o/6zTCWKQBxvG/6DlS1x0JQLJ

<link rel="stylesheet" href="https://doc.anagora.org/css/center.css"> <button class="pull-url" value="https://doc.anagora.org/css/center.css">">pull</button>

<div class="container-fluid text-center">
    <div class="vertical-center-row">
        <h1>500 Internal Error <small>wtf.</small></h1>
    </div>
</div>

• a [[server]].
  • #go https://discord.gg/QKZRqbESMm

agora discus

• [[pull]] [[agora discuss]]
• this could be an agora [[disc]] though I guess.

Agora Discuss

• a [[room]].
  • #chat #matrix
  • #go https://matrix.to/#/#anagora:matrix.org
  • [[discord servers]]
  • You can #push things here to make them known to the community :)
    • You can always start by using the [[stoa]] below.
  • [[logs]]
    • [[2022-04-15]] https://drive.google.com/file/d/1wAN9X725iEykhNUjlr-N9TwueAQqJsON/view?usp=sharing

Agora discuss

• [[node club]]

Backlinks

• • [[agora-discuss]]

Backlinks last generated 2022-01-28 07:55:20

<link rel="stylesheet" href="https://doc.anagora.org/css/center.css"> <button class="pull-url" value="https://doc.anagora.org/css/center.css">">pull</button>

<div class="container-fluid text-center">
    <div class="vertical-center-row">
        <h1>500 Internal Error <small>wtf.</small></h1>
    </div>
</div>

• a [[chapter]].
  • #push [[agora chapter]]
    • written for [[pkg book]].
    • #go https://docs.google.com/document/d/1DXJRDh9Ss5VCRBi3oirDw9d7yjn3H2hMqfN2ETTyjIc/edit?usp=sharing pull
    • #pull [[agora pkg chapter]] ~ [[agora chapter]] (these might converge, I use them in different contexts)
    • #pull https://docs.google.com/document/d/1DXJRDh9Ss5VCRBi3oirDw9d7yjn3H2hMqfN2ETTyjIc/edit#heading=h.lxyhsegwtr4m pull
    • the above should work, try iframes with [[google docs]]
      • it doesn't work :( "Google Docs benötigt Zugriff"
        • oh, but you can click on "click here" to get through!
          • only on Firefox
          • it doesn't work at all on Chrome :(
    • #comment https://docs.google.com/document/d/1DXJRDh9Ss5VCRBi3oirDw9d7yjn3H2hMqfN2ETTyjIc/edit?disco=AAAAhUbCJIQ pull
      • great top level comment by [[ivo]], see push here for summary (G1-G8).

• a [[feature]].
  • in... [[agora bridge]]?
  • #go https://developers.google.com/docs/api/samples/extract-text#python
  • [[do]] want to implement it using the above as a start
  • will support only public documents to begin with

Agora Editor

• To contribute to the [[Agora]], you need to write down notes or posts in one of the [[supported formats]] and upload your notes to a git repository of your choice. These steps are expanded below.
  • Get a [[github]] account if you don't have a git host already: https://github.com.
    • Install [[git]] if needed: https://git-scm.com/download. It should be installed by default in [[linux]], comes bundled with [[mac os]].
  • See [[agora signup]] for more details on the process.
• In a nutshell: you need to host your notes (more generally, [[resources]], defaulting to [[markdown]] plus [[wikilinks]]), somewhere online. And then let the [[agora]] know about it.
  • The Agora doesn't host your data, but rather pulls it from a location you control and renders it for you and other users; in the process interlinking your data with that of other users.
  • Most users currently host [[git]] repositories on https://github.com or https://gitlab.com.
  • Note using the default format (Markdown) lets you also easily publish your [[blog]] or [[digital garden]] independently online with tools such as [[jekyll]], [[gatsby]] or [[nikola]].
• As of [[2021-05-07]], the recommended Agora editor is:
  • [[foam]], if you want open source hosted locally.
    • [[foam]] is a [[vscode]] [[extension]].
    • [[foam]] is less straightforward to set up than the next options.
  • [[logseq]], if you want open source, value the convenience of a hosted setup, and use [[chrome]] or a [[chromium based browser]] (any browser but [[firefox]], essentially).
  • [[obsidian]] if you don't mind using closed software from a small ethical company, in particular a small one with a vibrant open source extension community.
    • You need at least also the [[obsidian git]] plugin. See [[obsidian plugins]] for more.
    • [[install obsidian]] by visiting https://obsidian.md and then follow [[vault backup]] to set up backup to [[git]]: https://docs.github.com/en/github/importing-your-projects-to-github/adding-an-existing-project-to-github-using-the-command-line pull.
    • Then follow the procedure below to add your vault or [[digital garden]] to the [[agora]].
  • You can also use:
    • [[dendron]], which should be a drop-in [[foam]] replacement in [[vscode]].
    • [[roam]] plus [[roam2agora]]
    • [[org mode]]
    • (In essence, all you really need to use the [[Agora]] is the capability to produce text in some format and make it publicly available somewhere. Plain text would suffice.)
• After getting yourself a [[repository]], you need to let an [[agora]] know about it so it can be pulled and integrated.
  • Please send a [[pr]] adding your garden to [[gardens yaml]], accepting the agora's [[contract]] and indicating your desired username; or reach out to signup@anagora.org, [[flancian]] or [[vera]] with information about your use case. We'll do our best to make it work! We want the [[agora]] to be maximally inclusive.
  • All [[agora]] users must agree to its [[contract]] as defined by the system account.
    • The contracts of other users can optionally be a [[endorsed]].
• My proposal to you now is that we use the capability of sharing and discovering context-relevant media at effectively zero cost for the greater good: let's agree on a protocol to escape [[vendor lock-in]] and cooperate optimally on projects of [[public utility]].
  • [[agora protocol]]

Agora Editors

• [[pull]] [[agora editor]]

• a [[proposal]]
  • proposal: name this [[agora]] [[elinor ostrom]].
  • [[mastodon]] https://social.coop/web/statuses/106228674151737915
  • [[twitter]]

⥅ [[Pasted image 20210513174950.png]]

agora embed

       <div class="stoa-public">
            <span class="subnode-header">[[agora]] at anagora.org</span>
            <iframe name="embed_readwrite" src="https://anagora.org/agora" <button class="pull-url" value="https://anagora.org/agora"">pull</button> width="100%" height="500" frameborder="0"></iframe>
       </div>

or just the iframe if you want to embed out-of-agora of course :)

Agora Es

• Qué es el [[Agora]]?
• El [[Agora]] es un poco como la máquina de escribir novelas de [[Macedonio]].
  • [[push]] [[macedonio]] https://twitter.com/flancian/status/1350150978943787008 pull
• En [[Flancia]] hay un [[Agora]].

• the other leg of [[agora protocol]]
  • the agora wants to support a variety of storage formats that facilitate exchange between [[tools for thought]]
    • [[markdown]] plus [[wikilinks]] is the current default
    • supported too:
      • [[plain text]]
      • [[hashtags]]
      • [[org mode]]
      • [[edn]] (planned)
  • [[hypothesis]] https://hyp.is/i3iUMtOSEeudHIML10vbwQ/iannotate.org/2021/program.html

• #push [[wikilinks everywhere]]
  • a [[browser extension]]
    • it makes [[wikilinks]] clickable on your browser on arbitrary websites... sometimes :)
    • by [[vera]], [[evan boehs]], [[flancia collective]].
    • [[firefox]] https://addons.mozilla.org/en-US/firefox/addon/agora/
    • [[chrome]] https://chrome.google.com/webstore/detail/agora/joalfhedjllnlphmdbegppmhchhmlddc
    • we had a bit of a confusion at some point and we ended up with two different repos, or maybe three :)

      • [[git]] https://gitlab.com/veracantcode/agora-ext

      • [[git2]] https://github.com/flancia-coop/wikilinks-everywhere
      • #go [[git2]]

• [[agora ext feature ideas]]

feature ideas for [[agora ext]]

• convert [[wikilinks]] into tweets when submitting tweet
• bookmark site and add node to [[agora]] with go link and title prepopulated from site

I realize that while this site is connected into [[Anagora]] (but that’s an instance, so I should be saying [[Agora]] instead?) that I don’t really know how it works! Or what the special features are!

What markup do I use to link to a “global” node? A particular user’s node?

For instance, this post will be imported there, under “my” node. How does someone, while writing in their agora, link to [[Agora FAQ]]?

Ideally I don’t want to have to break my flow and go look up a link. So, within some bounds of acceptable markup across different agora engines and their plain text representation in Git, what should this look like?

What Markdown features are supported? What non-Markdown features do I need to know about?

Footnotes are not (currently) supported. See my [[Goggles]] node in the agora for footnote examples.

What engines are supported? What engines do people currently run?

Anything whose source is Markdown pages in Git can be imported.

• [[Jekyll]]: @bmann

This is clearly a collaborative doc that should probably be an EtherPad linked to the Agora FAQ page

• #pull [[agora]] [[frequently asked questions]] [[agora faqs]] [[open agora questions]]

agora faqs

• a [[list]].
  • [[pull]] [[agora faq]]

Agora Feature Requests

• [[pull]] [[feature requests]]

• automatically pull nodes mentioned in the current node
• auto [[go link]] a url found in a node
• [ ]

• [[pull]] [[agora bridge]]
• [[push]] [[agora social media integration]]
  • you can use the [[agora]] protocol on any social media platform and express your intent to interact with the [[agora]] by communicating to one with one of our [[service accounts]] and the [[agora]] will try to integrate your content in whichever way you want, only for as long as you want to.
  • [[vera]] has picked this up! [[twitter bridge]]

Agora Feeds

• a [[feature]].
  • #push [[agora plan]]
    • The [[agora]] should support [[rss]] / [[atom]] feeds in two ways:
      • As a [[consumer]], to easily allow any feed producer to volunteer subnodes in an [[agora]].
        • I see this as part of the [[agora bridge]] effort.
      • As a [[producer]], to easily allow users and other systems to consume [[agora]] updates.
        • As of [[2022]] this exists:
          • /feed/node gives you a feed of subnodes in node.
          • /feed/latest gives you an Agora wide feed.
          • You can join #go https://matrix.to/#/#agora-feeds:matrix.org on matrix if you want to keep track of updates in a chat room.
  • #push [[python]] libraries
    • most popular: [[feedparser]]
    • new contender: [[atoma]]

Agora for EA

• [[Agora]] for [[Effective Altruism]].
  • https://twitter.com/flancian/status/1292786620329074690 pull
• Document: https://flancia.org/go/agora-ea pull

• a [[conference]].
  • #go https://agoraforum.ch/en/home/
  • [[2021]] [[switzerland]]

Agora Fuzzy Matching

• The Agora will make use of [[fuzzy matching]] to maximize the chances to surface relevant content.
  • Perhaps using [[levenshtein distance]]?
  • Some library?
• All of the following should be surfaced in unison whenever one of them is surfaced, likely:
  • [[wikilink]]
  • [[wikilinks]]
  • [[wikilinked]]
• There should be some support for [[acronym]]s as well:
  • [[united states]]
  • [[US]]
  • [[U S]]
• And perhaps, going further, [[united states of america]] should be consolidated with the preceding as well.
• [[ranking]] Perhaps fuzzy matched content is ranked lower than perfectly matched?

Agora FW

• Stoa

• [[did]]
  • map each repo to did then map users to did
• [[ucan]]

Agora Go Links Integration

• I have implemented this: when in an Agora subnode there is a block that begins with [[go]] and continues with a URL, the Agora will set up a [[go link]] with it and make it available at anagora.org/go/ + the node id. Example follows.
  • [[go]] flancia.org/mine/go-links
  • Because of the above block, if you visit anagora.org/go/agora-go-links-integration you'll be redirected to an article of mine on go links in flancia.org.
• This was implemented on [[2020-11-21]] in [[Agora plan]].
• Note currently I also run go links on https://flancia.org pull, my personal domain, and they're incomplete (they contain a subset of the go links in the Agora).
• Next up: handle the case in which several subnodes set up different go links.
  • Behaviour now: one is picked opaquely; the username with the username that comes first alphabetically "wins".
  • Expected behaviour: perhaps a list with all targets shows up, and then five seconds later the Agora redirects to the most highly ranked target (to begin with, the oldest?).

• My objective is to build a governance system into the [[agora]]
• proposals will be submitted as nodes
• people respond to proposals by creating a node with the same name as the proposal, any #tags will be counted as a vote
  • so e.g. you enter #yes into your node and someone else enters #yes as well there will be two votes for #yes, votes can be any tag name
• I want to add a /proposal route to the [[agora]] to have a special proposal view for governance

[[agora governance]]

• a [[thing]].
  • [[distributed knowledge graph]].
  • The brain of an [[Agora commons]].
  • See [[agora doc]].
• a [[project]].
  • I want to graph both the Agora as a whole and the context of a node in the agora, as per [[agora ui]].
  • local graphs: done (partial implementation).
  • global graph: running in dev but very resource intensive, may need to refactor/redo.
    • it could be cool to get a graph in [[agora doc]] though...
      • could be nice to do this through [[runnable subnodes]]:
        • [[javascript subnodes]]
        • [[python subnodes]]
    • did [[rdf]] first: exposed rdf for the agora and use something like [[rdf grapher]] to graph
  • #go https://twitter.com/flancian/status/1380210191837315073 pull

• The [[agora]] graph is an [[interlay]] between the [[underlay]] and the [[overlay]]
  • [[agora server]] is an overlay
  • [[mastodon]] [[twitter]] etc are underlays

• a [[project]].
  • #pull [[agora graph]]
  • https://twitter.com/flancian/status/1527360592599650308 pull

• idea that I had to use the agora like a social group
• pick a name e.g. [[leftist memes]] and then post comments/memes
• makes me wonder what multi posting to a term looks like. could we have a "feed" of content for nodes
• maybe "feed" content type

Agora Help

• An Agora is a [[distributed knowledge graph]] made up of notes, images, files, links.
• An Agora is built and maintained by a community according to its base [[CONTRACT]].
• Agora nodes are identified by their [[wikilink]]. [[wikilink]]s may resolve to more than one piece of content; this is not only fine, but considered desirable.
• Agora users volunteer content for nodes. Content is shown at that node, sequentially, according to a community maintained [[ranking algorithm]].
• What you're reading currently is a node like any other. If you contributed to this Agora, you could write and submit a note titled 'Agora Help' of your own and it would be shown in this location together with this one.
• If you would like to contribute to the Agora, there are two ways you can do that:
  • You can start taking notes, or assembling a [[digital garden]], and contribute them to the Agora. For more information on how to do this, please refer to the Agora Howto.
  • You can help develop the Agora; the Agora is open source and community driven. For more information on how to do this, please refer to README
• Please see [[agora editor]] if you'd like to participate.

Agora Hn

• [[go]] https://news.ycombinator.com/item?id=25573523
• [[twitter]] https://twitter.com/flancian/status/1344003756908818444 pull

Agora Howto

• To join an Agora:
  • [[pull]] [[agora signup]]
• To run an Agora:
  • [[pull]] [[agora install]]

Agora Hub

• The [[Agora]] is a bit about integrating the best out there, in a sense; that's what I believe could be a competitive advantage of open source.
• Companies are usually motivated not to cooperate with others, because they want an edge in the market. This forces them to close down, and it means every company needs to implement a lot of the same stuff independently. It's so inefficient.
• Open source can be fully open because it has open intentions. Every platform is open by default to collaboration, because openness is symmetric, and integrating with a product usually means users get something of value out of it for no recurring costs.
• n products or open platforms will tend to integrate, presumably, if they see value in it exceeding integration costs. The issue is that integrations themselves can be seen as costly, because they are by default a full graph, which has n! directed edges.
• The Agora is an attempt to work around this by clearly defining a neutral ground for willing parties to cooperate in. This common ground can then be used to build a hub. A hub is a highly connected node. In the previous graph of n, if all nodes trust hub h, complexity of integration drops to n.
• See also: [[Agora]], [[Agora Plan]], [[Agora Protocol]].
• [[go]] https://twitter.com/flancian/status/1330205461732323329 pull

Agora Hypothesis

• a [[group]].
  • [[go]] https://hypothes.is/groups/XMWwMJoe/agora
  • If you want to see all [[hypothes.is]] integrations in anagora.org:
  • [[pull]] https://hypothes.is/search?q=url:anagora.org/*

Agora Hypothesis Integration

• Interesting I didn't have this node until [[2020-12-12]].
• [[hypothes.is]] could be a great platform to implement [[agora comments]].
  • Trivially: each node could redirect to a via.hypothes.is URL for commenting inline.
• [[hypothes.is]] could be an [[agora client]]:
  • an interface to query your notes and [[Agora]] nodes in an Agora of your choice.
  • an interface for [[wikilinks everywhere]].
• [[do]] try embedding hypothesis in the Agora: https://web.hypothes.is/for-publishers/#embedding
• [[pull]] [[agora hypothesis]]

Agora Install

• a [[howto]].
  • These are instructions to [[run your own agora]]. If you are looking for instructions on how to join this Agora, please refer to: [[agora signup]], [[agora editor]].

Before you get started

As of the time of writing the [[Agora]] consists of three distinct repositories:

• The Agora proper, which contains the root of a tree plus instructions on how to grow it. This is defined by its configuration and its [[contract]].
  • -> [[go/agora]]
• The [[Agora Server]], a web interface to the Agora, mostly [[read only]]. It is the interface you're reading this in if you're in anagora.org.
  • -> [[go/agora-server]]
• [[Agora Bridge]], a repository that contains various means of writing to the Agora and more generally interfacing with it. This includes the process that interacts with the Agora's configuration (in the first repository in the list) and runs fetch/update tasks; and a set of platform-specific bots.
  • -> [[go/agora-bridge]]

The following instructions assume you clone all repositories and run all services under the same user in a Unix-like system (anagora.org runs on Debian GNU/Linux). We suggest agora:

$ adduser agora  # follow prompts
$ sudo su - agora

To get all repositories:

$ git clone https://github.com/flancian/agora.git
$ git clone https://github.com/flancian/agora-server.git
$ git clone https://github.com/flancian/agora-bridge.git

You need to clone all three to run a fully functioning Agora. Because the first is configuration only, and the third encapsulates all mutating code, you technically only need to run [[agora server]] as a service to run an immutable Agora. These instructions assume you set up all three in order.

Agora

• gardens.yaml contains the list of sources for this Agora.
  • may be renamed sources.yaml
  • (if the agora is a filesystem, this is the [[fstab]])
  • [[gardens yaml]]
• CONTRACT.md contains the Agora system account's public commitment to the ecosystem.

You need to edit gardens.yaml if you want to carry a different set of sources. The Agora comes with defaults.

If you edit the [[CONTRACT]], your Agora might become incompatible with the Agora you forked from. Conflict resolution is part of [[agora protocol]] but currently not specified.

[[Agora Server]]

• [[python]] backend, [[flask]] based.
• [[typescript]] frontend, no framework for now.

If you installed in non-standard paths (i.e. your repos are not in /home/<user>/<repo>), edit app/config.py.

You need to create a Python virtual environment, install packages from requirements.txt. run ./setup.sh and it'll at least try to point you in the right direction :)

You can then ./run-dev.sh (for development) or ./run-prod.sh (if you want to serve to the outside world). If you do the latter, you may want to set up [[uwsgi]] in [[nginx]] and make it stick as a [[systemd service]] using agora-server.service as an example. Please refer to https://github.com/flancian/agora-server#to-develop for details.

You can add an nginx virtual host with [[certbot]]: certbot --nginx -d example.anagora.org. Then use the following as an example to forward traffic in that virtual host to Agora Server over UWSGI:

   location / {
        include uwsgi_params;
        # /home/agora/agora-server/run-prod.sh to run.
        uwsgi_pass unix:/tmp/agora-uwsgi.sock;
    }   

Agora Bridge

• [[python]]
  • [[gardens py]]
• [[yaml]]
  • [[gardens yaml]]
  • [[agora bot yaml]]
• [[typescript]] You need to create a Python virtual environment, install packages from requirements.txt. run ./setup.sh and it'll at least try to point you in the right direction :)

Then run ./run-prod.sh either on a shell or as a [[systemd service]]. This will pull from all sources in the root repository's gardens.yaml in a loop.

You can also optionally run a number of bots that will interact with people in supported platforms. See the bots directory and https://github.com/flancian/agora-bridge#install for more.

And now?

Now that you have a functioning Agora, consider what you will do with it.

Please consider [[agora protocol]], [[contract]] and [[goals]]. Reach out if you are interested in establishing other protocols for [[collaboration]].

A note on Docker support

There is currently no [[docker]] support, but it seems like it could be a great fit. We have this in our plan, but if you're handy with Docker, this would be a great contribution for you! :)

• #push [[other agoras]]
  • explicitly defined as such:
    • [[agora of flancia]] ~ https://anagora.org pull
    • [[shamanic agora]] being built
    • [[ogm agora]] currently having the form of [[open global mind]]'s [[mattermost]]
    • [[social.coop agora]] being considered (at least by me!)
  • implicitly, aligning in values
    • other listed in [[other agoras]] and such

Agora Integration

• Agora integrations might be gateways to other services that allow the [[Agora]] to interop with them; usually mapping to [[actions]].
• See [[agora plan]] and [[agora feature requests]] for a list of planned integrations.

• [[agora interlay howto]]

• These are instructions on how to add your [[digital-garden]] to the highly experimental interlay version of the [[agora]]

  • If you have any questions feel free to contact me
    • #email veronika.m.winters@gmail.com
    • #twitter @flanciavera
    • #matrix vera@fairydust.space
  • I'll be happy to add you manually on request

• Fork our repo on github https://github.com/flancia-coop/agora

• clone your repo

  • git clone <url to your fork>

• cd into repo

  • cd agora

• import your own repo as a submodule

  • git submodule add <url to your repo> <your desired name>

• add files to index

  • git add .

• create commit

  • git commit -m "submodule"

• push changes back to your fork

  • git push origin master

• create pull request

• [[agora]] sometimes crashes [[firefox]] on my machine
  • might be [[agora ext]]

#issues

agora js

Agora Like

• #pull [[fedwiki]] [[federated wiki]]
• #pull [[mycorrhiza]] [[betula]]
• #pull [[massive wiki]]
• #pull [[Yubnub]] is a general purpose keyword-based social redirector which incorporates some of the same community shaped aspects that drive the Agora, in particular Agora Actions like Go. The Agora of Flancia redirects queries to Yubnub for some prefixes.
• #pull [[Cosma]] “is a document graph visualization tool. It renders interlinked plain text files as an interactive network in a web interface.”
• #pull [[solid]]
• #pull [[codex editor]]
• #pull [[roamanpub]] [[roaman agora]]
• #pull [[pubpub]]

Agora Links

• flancia.org/agora/go_link
• Could be built on top of generated nginx redirect configurations. Sounds easy and potentially actually fast.
• [[Turing]] and [[Lovelace]] are patron scientists of the Agora (?). [[Hypatia]] might be patron philosopher.

• a [[bot]].
  • in [[agora bridge]].
  • #pull [[agora mastodon integration]] [[agora bot mastodon]]

Agora Mastodon Integration

• [[pull]] [[agora fediverse integration]]

• [[admin]] http://anagora.org:29316/_matrix/maubot/#/ pull
• #pull [[agora bot matrix]]
  • #go https://github.com/flancian/agora-bot-matrix

• [[metasj]] There's no RC for cat membership, but https://www.mediawiki.org/wiki/API:Categorymembers pull returns a full current list, and for incremental updates https://www.mediawiki.org/wiki/API:Usercontribs pull with ucshow=new returns new pages created by a user.
• [[metasj]] The only schema would be (extracting local agora name from mw page-title prefix). Other processing: Link extraction would be looking at each wikilink on the MW page and a) converting to an agora link if the target is also a [[category:agora]] page, b) interpreting other [[localname:title]] links or [https://url external links] as agora links if the target agora is known (and the localname: is not also the name of a local MW namespace)

Related MW plugin: "cascading wikilinks" -- a patch to the link-generator JS widget, which currently automatically generates the proper MW markdown for an external URL or a local wikipage, that a) recognizes a cascading list of agoras. So I can write "flancia:agora", link it, press enter, and have it resolve b) option: automatically adds a footnote w/ a "see also: [[article]]" when there's an entry in a Wikimedia-namespace w/ the same term.

• a [[meet]].
  • we have [[flancia meet]] on Saturday mornings (UTC), [[agora meet]] would probably ideally take place some day in the afternoon (UTC) so it can be more easily attended by people west?
  • Update (2022-08-21): first instance happening on a Sunday morning.
  • #go https://meet.jit.si/agora-meet

[[2022-08-21]]

• See [[stoa]] below.

Agora Meet

<link rel="stylesheet" href="https://doc.anagora.org/css/center.css"> <button class="pull-url" value="https://doc.anagora.org/css/center.css">">pull</button>

<div class="container-fluid text-center">
    <div class="vertical-center-row">
        <h1>500 Internal Error <small>wtf.</small></h1>
    </div>
</div>

Agora Music

• the [[agora]] could take [[nodes]] of type [[playlist]] and assemble playable playlists for users in a variety of platforms: [[youtube]], [[spotify]], etc.

[[push]] [[agora frs]]

[[Feature request]]

The [[Agora]] already has [[action]]s that indicate [[transclusion]] (with directions) through push and push. We should also have [[action]]s to indicate garden-side [[node]] [[aliasing]].

Node aliasing is useful for allowing an user to deviate from conventions about node naming, while still maintaining [[wikilink]]s as [[first-class citizen]]s.

Possible syntaxes

We should have multiple conventions:

Inline:

• tag action: #alias [[node]]

• link action: [[alias]] [[node]]

• list:

    - [[alias]]
    	- [[node]]
    	- [[page]]
    	- [[entry]]
    	- [[thread]]
    - #alias 
    	- [[nickname]]
    	- [[pseudonym]]
    	- [[aka]]
    	- [[also known as]]
  

• [[@flancian]]: [[node]] == [[node]]

Front matter/Global files

• Markdown front matter: agora-alias: node

• HTML data attribute: data-agora-alias='node'

• (in the future) [[agora garden yaml file]]:

    agora-alias:
    	- node:
    		- page
    		- entry
    		- thread
    	- alias:
    		- nickname
    		- pseudonym
    		- aka
    		- also known as
  

• #pull [[agora]] [[node]]
  • In the Agora, each node is a [[concept]], or a [[thing]], or a [[topic]].
  • Links relate nodes to each other meaningfully.

• https://github.com/obsidianmd/obsidian-sample-plugin
• MVP
  • detect nodes in the [[agora]] and display that in obsidian somehow

#plugin

• The [[Agora of Flancia]] is just [[an Agora]].
• #pull There are [[many Agoras]]; I'm writing this in the [[Agora]] of [[Flancia]].
  • #go https://anagora.org pull

• an [[agora]].
  • This [[Agora]], https://anagora.org pull, is an [[Agora of Flancia]].
  • This means:
    • It counts as its goals to get all willing parties closer to [[Flancia]] [[non-violently]].
    • It contains a free [[knowledge commons]].
      • It contains a repository of [[patterns]] for [[world improvement]].
        • It is a [[platform]] for practicing [[loving kindness]] and [[fractal altruism]].
        • It is a [[device]] for exploring social reform [[experiments]] like [[basic income]] and [[liquid democracy]].

<link rel="stylesheet" href="https://doc.anagora.org/css/center.css"> <button class="pull-url" value="https://doc.anagora.org/css/center.css">">pull</button>

<div class="container-fluid text-center">
    <div class="vertical-center-row">
        <h1>500 Internal Error <small>wtf.</small></h1>
    </div>
</div>

• #pull [[open agora questions]]

agora osm

• an [[integration]].
  • it'd be nice to integrate [[open street map]] with the [[agora]], and the other way around.
    • say, every time a node makes a reference to a place, embed [[osm]].
    • also let people use the [[agora]] to easily contribute to [[osm]]? some way of giving back.

agora outage

• the [[agora]] went down significantly today (at least 10 minutes) for the first time I'm aware of since at least the beginning of the year.
  • I've procrastinated on implementing best practices so there's plenty to analyze in this postmortem! I'm looking forward to it.
  • [[you can run an agora in your laptop]]

• a [[paper]].
  • I'm trying to write (as of [[2022-07]].)
  • As part of the contribution I'm trying to put together for the [[pkg book]].
  • #pull [[agora pkg chapter]] [[agora slides]]
  • #push [[todo]]
    • [[write]], this is a top priority in [[august 2022]].
    • this should probably show up at the top of [[todo]] and not at the bottom!

Meta

By default, this paper will be built around the following:

• The [[Abstract]] below, taken from a snapshot of the above on [[2022-08-05]].
• #pull [[agora pkm chapter]] with greater technicality?
  • Define [[m]], [[m prime]], morphisms.
    • (An Agora as a category?)
  • Define [[Agora Protocol]] operations.
    • [[print]]
    • [[broadcast]]
    • [[share]]
    • [[assert]] ~ [[m]]
    • [[intent]] ~ [[m prime]]
    • [[delegate]]
      • -> [[liquid democracy]]
    • [[pull]] (a [[node]], as transcluding, incorporating a [[pattern]].)
    • [[push]] (a [[node]]), as if meaning publishing to a [[topic]].)
    • [[go]] (to a [[node]], or [[URL]].)
    • [[fork]] ([[a commons]].)
    • [[merge]] ([[n commons]].)
• #pull [[a pattern language]]
• #pull [[a rosetta stone]]
• #pull [[i am a strange loop]]

Abstract

In this [[paper]] we describe an Agora, a [[social knowledge graph]] provisioned and maintained by a self-governing community as a commons.

The Agora [[knowledge graph]] can be defined as a hypergraph A with a set of k nodes N (entities an Agora knows about) integrated out of subnodes SN_0 .. SN_k containing subedges SE_0 .. SE_k, aggregating into edges E_0 .. E_k (semantic links between entities inferred out of known subnodes). Edges are annotated implicitly by link context and explicitly via the use of [[agora protocol]], which is extensible and tries to build on existing conventions in the [[personal knowledge management]] space.

An Agora differs from other projects in the personal knowledge space in a few ways: whereas a personal knowledge graph usually contains resources authored or collected by a single person, and a wiki usually contains resources produced by a group, an Agora contains, integrates and interlinks both personal and group resources. Whereas links in a personal knowledge graph or wiki usually have a single target, Agora links fan out by default and can be thought of as mapping to sets of resources. This is consistent with the general design principle of facilitating storage and retrieval of entity-mapped information towards removing friction from cooperation.

Building on the general principles above and a [[free software]]¹ reference implementation of the underlying protocols and data, we model and detail how to implement a distributed system that provisions social knowledge services ethically and sustainably, upholding [[data sovereignty]] principles. We then analyze some of the potential applications of such a system. Finally, we shortly explore future work and social implications assuming that the Agora is run as a [[confederated]] system for the [[public good]].

Introduction

As per [[agora pkm chapter]] by default?

Background

• #pull [[a pattern language]]
• #pull [[a rosetta stone]]
• #pull [[the expanding circle]]